home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / hardware / apm3303.lha / AddPicassoMem.doc < prev    next >
Text File  |  1994-11-06  |  10KB  |  213 lines
  1.  
  2. ##############################################################################
  3.  
  4.  ###  ####  ####   ####  ##  ###  ###   ###  ###   ###   ##   ## ##### ##   ##
  5. ## ## ## ## ## ##  ## ## ## ##   ## ## ##   ##    ## ##  ### ### ##    ### ###
  6. ##### ## ## ## ##  ####  ## ##   #####  ###  ###  ## ##  ####### ####  #######
  7. ## ## ## ## ## ##  ##    ## ##   ## ##    ##   ## ## ##  ## # ## ##    ## # ##
  8. ## ## ####  ####   ##    ##  ### ## ##  ###  ###   ###   ##   ## ##### ##   ##
  9.  
  10. ##############################################################################
  11.  
  12.  
  13.                                 VERSION 33.03
  14.  
  15.  
  16. This  is  the second public release of AddPicassoMem (APM for short) a program
  17. to use the memory of the VillageTronic Picasso-II graphics card as public fast
  18. memory.
  19.  
  20.  
  21.                                  WHY I DID IT
  22.  
  23.  
  24. I  know it's a shame to waste the graphics capabilities of this great card and
  25. use just its memory, but my A3000 has still V36 ROM's and sometimes I fallback
  26. to  kickstart 1.3 to play some game...  Under 1.3 The Picasso-II can't be used
  27. as graphics card, and its memory stays there doing nothing!
  28. I  have  2  Mb  chip  and  8 Mb fast, and the Zorro2 bus performance is not so
  29. exciting:   Zorro2  memory cards are much slower than chip ram on A3000's, but
  30. one night I was thinking to all the A2000ers who maybe may like a utility like
  31. this:  how about a 1Mb or 2Mb fast ram expansion for free?
  32. I strongly recommend you to use your Picasso-II to e.g. show Hajime Sorayama's
  33. or Boris Valejo's JPEGs rather than to contain some million numbers, anyway if
  34. you really need more memory this may be a cheap solution.
  35.  
  36.  
  37.                               CONFIGURING A CARD
  38.  
  39.  
  40. "Configure a card" means tell AmigaDOS what the card is made for.
  41. Once  a  card is configured via the BindDrivers command it can't be configured
  42. again  (until you reset, naturally), so the first step to make APM work is NOT
  43. to run the BindDrivers command.
  44. If  you  configure the card using APM, BindDrivers will not try to reconfigure
  45. it  until you don't remove the Picasso-II memory chunk from public list.
  46. This  means  that  when  Picasso-II  memory  is  available for public use, the
  47. village.library  will  not  be loaded and the AmigaDOS thinks that the card is
  48. just an expensive fast memory expansion.
  49. Configuring  the Picasso-II using APM gives you one advantage:  if you need to
  50. use  the  card  for its graphics capabilities, you can still backup a move and
  51. dismount the memory (if nobody is using it).
  52. Naturally  to  reconfigure  the  card  as graphics engine you will need to run
  53. BindDrivers  and then you will not be able to use APM again, but you can mount
  54. and  dismount  Picasso-II  memory  as  many times as you like, until you don't
  55. run the BindDrivers command.
  56.  
  57.  
  58.                                     USAGE
  59.  
  60.  
  61. APM  is  a stand alone CLI/Shell-only program that can run under kickstart 1.2
  62. and later releases.
  63. If you give it no arguments it will try to mount the memory chunk, if you give
  64. it  the  "remove"  switch argument it will try to remove the memory chunk, any
  65. other  argument  will  show  you  a  help  line.   All  the rest is automagic:
  66. starting  address  and  size  of  the card are fetched directly from the card,
  67. priority will be the lowest fast ram priority less one, or zero if no fast ram
  68. is installed.
  69.  
  70. Return codes on program exit may give a rough idea of what happened:
  71. OK    (0) = All right, memory has been added/removed to/from the public list
  72. WARN (10) = Error in the command line arguments
  73. FAIL (20) = APM is not able to add/remove memory to/from the public list
  74.  
  75. Every  return  code  is  followed by a standard output message. Warn status is
  76. followed  by  "REMOVE/S: TRY TO REMOVE PICASSO-II PUBLIC MEMORY",  okay status
  77. can be followed by one of this two messages:
  78.  
  79. ADDING MEMORY $aaaaaaaa-$bbbbbbbb, PRI: (-)ccc
  80. memory chunk has successfully been added to the public list.
  81. card is now in ram only mode and can't be used as graphics engine.
  82. aaaaaaaa is the chunk's starting address
  83. bbbbbbbb is the chunk's ending   address
  84. ccc      is the chunk's priority 
  85.  
  86. PICASSO-II MEMORY REMOVED
  87. memory chunk has successfully been removed from the public list.
  88. card is now ready for a new configuration as graphics engine or again as a ram
  89. only card.
  90.  
  91. Finally, the following are the fail status messages:
  92.  
  93. CAN'T OPEN EXPANSION.LIBRARY
  94. expansion  is  a resident library and must always be available to any program,
  95. so  this  error message should never appear.  If it does appear, maybe you are
  96. trying to run APM on a 5000 MegaMips Amiga.  Just load the last (I know, it is
  97. 20 years old) 680x0 version of the operating system and try again! ;-)
  98.  
  99. PICASSO-II DRIVER ALREADY IN USE
  100. cannot add memory when village.library is loaded.
  101. village.library is the video driver of the card, if it is found in memory, the
  102. card  is already configured as graphics board.  this is due to the BindDrivers
  103. mambo-jambo (see "configuring a card").
  104.  
  105. PICASSO-II CARD IS IN SEGMENTED MODE
  106. cannot add memory if the card has been installed in segmented mode.
  107. this  will  happen  only  on 68000 or 68010 Amiga's with 8Mb of fast ram other
  108. than  the  one on the Picasso-II.  The largest segment is 1/16th of the memory
  109. on the card, I think adding 64Kb to the public list makes no sense.
  110.  
  111. PICASSO-II CARD NOT CORRECTLY INSTALLED
  112. cannot  add  memory if the card is not correctly installed or not installed at
  113. all. for my own information: does the card work in graphics engine mode?
  114.  
  115. PICASSO-II CARD ALREADY IN USE
  116. cannot  add  memory  if the card is currently configured either in ram only or
  117. graphics  engine  mode.   if  the  card  is  working  in ram only mode you can
  118. dismount  the  memory  and  re-mount  it  (why?).   if  the card is working in
  119. graphics  engine mode there is nothing to do other than resetting the Amiga if
  120. you want to use the card as memory expansion (BindDrivers mambo-jambo).
  121.  
  122. CAN'T WRITE TO PICASSO-II MEMORY
  123. cannot add memory if the card is write protected.
  124. when  you  boot, the memory on Picasso-II can't be written, but after a bit of
  125. initialization it can be write enabled.
  126. since  I  don't  have any technical doc on waking up this card, I wrote my own
  127. initialization  routine  which  can  have  some wrong timing.  I think it will
  128. always work thanks to Buster, if it does not, it's a programmer's fault :(
  129.  
  130. CAN'T FIND PICASSO-II MEMORY ADDRESS
  131. cannot add memory if the software coordinates of the card are unknown.
  132. when you boot, each card can be put anywhere in memory.  If there's not enough
  133. addressing  space  for  all the cards, some card may be left off.
  134. this error should appear if you didn't set correctly the segmented mode jumper
  135. on  the  card,  in other words the card is in normal mode when it should be in
  136. segmented mode.
  137.  
  138. PICASSO-II MEMORY ALREADY IN PUBLIC LIST
  139. cannot add memory twice.
  140. you  already  added  the memory to the public list (now the only thing you can
  141. do, if you wish, is to remove it).
  142.  
  143. PICASSO-II MEMORY NOT IN PUBLIC LIST
  144. cannot remove the memory chunk if it hasn't been added.
  145. this  message  is  shown when you didn't add the memory to the public list but
  146. it  also appears if you renamed the memory chunk.  actually the case dependent
  147. chunk name is "picasso2 memory", you can restore this name and try again.
  148.  
  149. MANGLED PICASSO-II MEMORY HEADER
  150. cannot remove the memory chunk if it was modified by someone else.
  151. maybe  someone  moved  the address of the memory header node.  then APM can do
  152. nothing legal to rescue the original structure.
  153.  
  154. PICASSO-II MEMORY IN USE
  155. cannot remove the memory chunk while it is in use.
  156. someone allocated part of the Picasso-II memory for its purposes, so the whole
  157. chunk  cannot  be freed until all the memory has been released.  if Picasso-II
  158. memory  is not free, APM tries to flush all the resident modules before giving
  159. up.  I flagged Picasso-II memory in a way that system friendly reset resistant
  160. modules can't be allocated in its space (fast, public, 24bitdma).
  161.  
  162.  
  163.                                  DISTRIBUTION
  164.  
  165.  
  166. This  package  is  released under the concept of freeware, the package must be
  167. distributed  as one whole.  The distributor may charge a fee up to the cost of
  168. the medium for the entire package.
  169. This  package, or part of it, cannot be included with commercial distributions
  170. without written permission from the author, however this document is a written
  171. permission to include this package in the Picasso-II firmware disks and in any
  172. CD-ROM collection.
  173.  
  174.  
  175.                                  NO WARRANTY
  176.  
  177.  
  178. This package is provided as is, without warranty of any kind, either expressed
  179. or implied.
  180. Should  the  package  prove  defective,  you  assume  the  entire  cost of all
  181. necessary  servicing,  repair or correction even if I have been advised of the
  182. possibility of such damages.
  183. I'm not responsible of the results of the use of the package.
  184.  
  185.  
  186.                                    HISTORY
  187.  
  188.  
  189. 33.01 (02-May-94) First public release
  190.  
  191. 33.02 (24-Oct-94) Testers only release
  192.  
  193. 33.03 (06-Nov-94) BUGFIX: APM 33.01 returns "already in public list" if there
  194.                   are other Zorro2 expansion boards AND if the Picasso-II is
  195.                   not in the first slot (I accidentally swapped the board
  196.                   address and the board size variables in a subroutine).
  197.                   Thanks to:
  198.                   Gabriele Bonora for the bugreport,
  199.                   Gabriele Greco  for the bugreport and the hint for bugfix
  200.                   (Thanks again: That bug would be very hard to find
  201.                   without your source-code level help).
  202.  
  203.  
  204.                                    SUPPORT
  205.  
  206.  
  207. If  you  have  any  suggestions, bug reports, or wish to let me know something
  208. about the package feel free to contact me at nsoggia@telnetwork.it
  209.  
  210. Have fun,
  211. /\/ / /-<
  212.  
  213.